コンビニ決済 インタフェース
概要
リンクタイプ Plus決済では、決済手段としてコンビニ決済を利用することが可能です。コンビニ決済を利用するには、実行パラメータセットにコンビニ決済に必要なパラメータを渡す必要があります。
リンクタイプ Plus決済でコンビニ決済が完了すると、遷移先URLにコンビニ決済の結果パラメータが返却されます。
遷移先URLは設定により異なるパラメータを参照します。
詳細は「決済画面からの加盟店様サイトへの遷移」をご覧ください。
入出力パラメータ仕様
実行パラメータ仕様
コンビニ決済固有の実行パラメータは以下の通りです。
json key | 詳細 | 指定可能箇所 | システムデフォルト設定 | ||
---|---|---|---|---|---|
リンクタイプPlus決済URL | 加盟店デフォルト設定 | ||||
cvs |
コンビニ決済固有実行パラメータコンビニ決済固有実行パラメータ |
〇 | 〇 | (null) | |
CustomerName | 全半角40バイト
氏名お客様の氏名を指定できます。リンクタイプ Plusの画面上で、お客様に入力頂くことも可能です。 セブン-イレブンを指定した場合は、半角記号は使用できません。 |
〇 | - | (null) | |
CustomerKana | 全半角40バイト
フリガナお客様のフリガナを指定できます。リンクタイプ Plusの画面上で、お客様に入力頂くことも可能です。 |
〇 | - | (null) | |
TelNo | 半角数字13桁
電話番号お客様の電話番号を指定できます。リンクタイプ Plusの画面上で、お客様に入力頂くことも可能です。 |
〇 | - | (null) | |
PaymentTermDay | 半角数字3桁
支払期限日数支払期限日数を指定できます。詳細は「コンビニ決済 支払期限について」をご覧ください。 |
〇 | 〇 | 10 | |
PaymentExpiryDateTime | 半角数字12桁 固定
支払期限支払期限を日時指定できます。(yyyyMMddHHmm形式)例:202308222359 省略時は、支払期限日数で処理されます。 支払期限日数と本パラメータどちらも設定した場合は本パラメータが優先されます。 支払期限を超過した取引のURLでは、決済選択/入力画面でコンビニ決済を選択できません。 詳細は「コンビニ決済 支払期限について」をご覧ください。 |
〇 | - | (null) | |
MailAddress | 半角英数記号256桁
結果通知先メールアドレス「コンビニ決済依頼完了のお知らせ」メールを送信する場合は、お客様のメールアドレスを設定してください。リンクタイプ Plusの画面上で、お客様に入力頂くことも可能です。 |
〇 | - | (null) | |
MailAddressRequiredFlag | 半角数字1桁
結果通知先メールアドレス必須フラグONにすると、リンクタイプ Plusの画面上での結果通知先メールアドレスの入力が必須になります。0:OFF(任意入力) 1:ON(必須入力) 各設定時の画面イメージは下記のとおりです。 |
〇 | 〇 | 0 | |
ShopMailAddress | 半角英数記号256桁
加盟店結果通知先メールアドレスお客様へ「コンビニ決済依頼完了のお知らせ」メールを送信する際に、同時に加盟店様にも送信する場合のメールアドレスを指定可能です(BCCに設定されます)。省略時は、ショップ情報に設定されたメールアドレスで処理されます。 |
〇 | 〇 | (null) | |
ReserveNo | 半角英数20桁
予約番号Loppi・ Famiポートを使用した際にバウチャー受領書に表示されます。 |
〇 | - | (null) | |
MemberNo | 半角英数20桁
会員番号Loppi・ Famiポートを使用した際にバウチャー受領書に表示されます。 |
〇 | - | (null) | |
RegisterDisp1 | 全角32バイト
POSレジ表示欄1ショップ名称を設定可能です。 |
〇 | 〇 | (null) | |
RegisterDisp2 | 全角32バイト
POSレジ表示欄2設定すると、POSレジに表示されます。 |
〇 | 〇 | (null) | |
RegisterDisp3 | 全角32バイト
POSレジ表示欄3設定すると、POSレジに表示されます。 |
〇 | 〇 | (null) | |
RegisterDisp4 | 全角32バイト
POSレジ表示欄4設定すると、POSレジに表示されます。 |
〇 | 〇 | (null) | |
RegisterDisp5 | 全角32バイト
POSレジ表示欄5設定すると、POSレジに表示されます。 |
〇 | 〇 | (null) | |
RegisterDisp6 | 全角32バイト
POSレジ表示欄6設定すると、POSレジに表示されます。 |
〇 | 〇 | (null) | |
RegisterDisp7 | 全角32バイト
POSレジ表示欄7設定すると、POSレジに表示されます。 |
〇 | 〇 | (null) | |
RegisterDisp8 | 全角32バイト
POSレジ表示欄8設定すると、POSレジに表示されます。 |
〇 | 〇 | (null) | |
ReceiptsDisp1 | 全角60バイト
レシート表示欄1設定すると、レシートに表示されます。 |
〇 | 〇 | (null) | |
ReceiptsDisp2 | 全角60バイト
レシート表示欄2設定すると、レシートに表示されます。 |
〇 | 〇 | (null) | |
ReceiptsDisp3 | 全角60バイト
レシート表示欄3設定すると、レシートに表示されます。 |
〇 | 〇 | (null) | |
ReceiptsDisp4 | 全角60バイト
レシート表示欄4設定すると、レシートに表示されます。 |
〇 | 〇 | (null) | |
ReceiptsDisp5 | 全角60バイト
レシート表示欄5設定すると、レシートに表示されます。 |
〇 | 〇 | (null) | |
ReceiptsDisp6 | 全角60バイト
レシート表示欄6設定すると、レシートに表示されます。 |
〇 | 〇 | (null) | |
ReceiptsDisp7 | 全角60バイト
レシート表示欄7設定すると、POSレジに表示されます。 |
〇 | 〇 | (null) | |
ReceiptsDisp8 | 全角60バイト
レシート表示欄8設定すると、レシートに表示されます。 |
〇 | 〇 | (null) | |
ReceiptsDisp9 | 全角60バイト
レシート表示欄9設定すると、レシートに表示されます。 |
〇 | 〇 | (null) | |
ReceiptsDisp10 | 全角60バイト
レシート表示欄10設定すると、レシートに表示されます。 |
〇 | 〇 | (null) | |
ReceiptsDisp11 | 必須全半角42バイト
お問い合わせ先Loppi・ Famiポートを使用した際にバウチャー受領書に表示されます。管理画面からURL生成する場合は、設定>決済設定>コンビニ設定>お問合せ先 にて必ず設定ください。 未設定時、利用可能決済手段にコンビニ決済が含まれている場合はお客様が画面を表示した際エラーになります。 |
〇 | 〇 | (null) | |
ReceiptsDisp12 | 必須半角数字12桁
お問い合わせ先電話番号Loppi・ Famiポートを使用した際にバウチャー受領書に表示されます。管理画面からURL生成する場合は、設定>決済設定>コンビニ設定>お問合せ先電話番号 にて必ず設定ください。 未設定時、利用可能決済手段にコンビニ決済が含まれている場合はお客様が画面を表示した際エラーになります。 |
〇 | 〇 | (null) | |
ReceiptsDisp13 | 必須半角数字記号11桁
お問い合わせ先受付時間Loppi・ Famiポートを使用した際にバウチャー受領書に表示されます。例)09:00-18:00 管理画面からURL生成する場合は、設定>決済設定>コンビニ設定>お問合せ先受付時間 にて必ず設定ください。 未設定時、利用可能決済手段にコンビニ決済が含まれている場合はお客様が画面を表示した際エラーになります。 |
〇 | 〇 | (null) |
結果パラメータ仕様
コンビニ決済を選択した場合に、加盟店様に返却するコンビニ決済固有の結果パラメータは以下の通りです。
cvs | 半角英数32桁 固定
コンビニ決済固有部コンビニ決済固有の結果パラメータセットです。 |
|
---|---|---|
Status |
取引状態取引の状態を示す以下の値が設定されます。REQSUCCESS:要求成功(お客様に、お支払いに必要な情報を提供した状態) PAYSUCCESS:決済完了(お客様がお支払いを完了した状態) EXPIRED:期限切れ(お客様がお支払いされることなく、有効期限が切れてしまった状態) CANCEL:支払停止(決済した取引の支払いを停止した状態) ERROR:決済エラー(決済時にエラーが発生した状態) |
|
TranID | 半角英数28桁
トランザクションID弊社が処理を行うごとに発行している処理番号が設定されます。 |
|
TranDate | 半角数字14桁
決済日時決済依頼を実施した日時が設定されます。(yyyyMMddHHmmss形式) |
|
CvsCode | 半角英数5桁
支払先コンビニコードお客様が選択したコンビニコードが設定されます。 |
|
CvsConfNo | 半角数字20桁
確認番号お客様がお支払い時に使用する番号が設定されます。 |
|
CvsReceiptNo | 半角数字32桁
受付番号お客様がお支払い時に使用する番号が設定されます。 |
|
PaymentTerm | 半角数字14桁
支払期限日時お客様の払込期限が設定されます。(yyyyMMddHHmmss形式) |
|
FinishDate | 半角数字14桁
決済完了日時お客様が決済を行った日時が設定されます。(yyyyMMddHHmmss形式) |
|
ReceiptDate | 半角数字14桁
受付日時受付日時が設定されます。(yyyyMMddHHmmss形式) |